revelplayer/com.reveldigital.player.api/[androidJvm]SkipSourceException

SkipSourceException

open class SkipSourceException : Exception

An exception thrown by a onSourceStarted implementation to signal that the currently starting content Source should be skipped by the playback engine.

When this exception is thrown from onSourceStarted, the player will typically:

  1. Prevent the associated Source from being played or displayed.
  2. Not record the playback of this source in any play logs or analytics.
  3. Proceed to the next item in the playlist, if applicable, or follow standard playlist completion logic.
This provides a mechanism for dynamically controlling the playback flow based on custom logic within the listener, such as conditional skipping of content.

As a checked exception, it must be declared in the throws clause of onSourceStarted.

See also

Constructors

Link copied to clipboard
constructor()
Constructs a new SkipSourceException with null as its detail message.
constructor(message: String)
Constructs a new SkipSourceException with the specified detail message.
constructor(message: String, cause: Throwable)
Constructs a new SkipSourceException with the specified detail message and cause.
constructor(cause: Throwable)
Constructs a new SkipSourceException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).